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Preface 


Prerequisite Documents 


Companion Documents 


This manual describes problems that can arise during normal use of the SunOS 
system and a number of its utility programs. 

NOTE This manual does not cover procedures for system maintenance, malfunctions, or 

troubleshooting. For information about those topics, refer to System and Net¬ 
work Administration. 

Chapter 1 is an introduction. It includes a list of important problems, and steps to 
prevent or work around them. 

Chapter 2 describes problems logging in and out. 

Chapter 3 describes error messages that can happen when ranning commands and 
what they mean. 

Chapter 4 describes error messages for selected commands. 

Chapter 5 describes problems and error messages that can occur when editing 
text files. 

Appendix A describes error messages that can occur when using remote systems 
over the network. 


We suggest the following reading order for the Beginner’s Guides: 

Getting Started with SunOS: Beginner’s Guide 

SunView 1 Beginner’s Guide 

Mail and Messages: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 

Doing More with SunOS: Beginner’s Guide 

SunOS Reference Manual 
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Introduction 


When you begin using any new piece of equipment, problems can arise that seem 
to require prior experience to avoid or correct. Remember your first few 
encounters with a sewing machine or with car repairs? 

A bit of guidance can be most helpful when you know what you are trying to 
accomplish, but have hit a snag. This manual is intended to provide you with 
pointers to get through the sorts of problems that many beginners find perplex¬ 
ing. The majority of problems most users face stem from simply not knowing 
what to do in a given situation. 

NOTE This manual describes basic problems that can confront the beginning user who 
lacks experience with a powerful operating system such as SunOS. It is not 
intended to resolve problems with installation, internal operation, or diagnosis 
of equipment or software. Refer to System and Network Administration for infor¬ 
mation about system maintenance and related topics. 

This chapter describes initial steps for dealing with any problem, lists some of 
the most serious ones you may encounter, and describes what you can do about 
them. Subsequent chapters deal with problems that may come up when perform¬ 
ing activities, such as logging in and out, running commands or editing files. 

1.1. Discovering A Problem There is never a convenient time to discover that you have a problem. As a 

beginning user, a problem typically comes to your attention when the system 
displays a message such as: 

File not found. 

Command not found, 
or 

Permission denied 

Messages like this can be both perplexing and disturbing, but there is a reason 
behind each one. Often, the reason becomes obvious as soon as you think about 
it, but sometimes it takes a bit of detective work to figure out. 
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4 Self-Help with Problems 


Since detective work can be difficult 
when you don’t know where to look, 
it may help to befriend an experi¬ 
enced user who can diagnose prob¬ 
lems that are especially puzzling. 


Whenever a problem occurs, there are some steps that you can take to minimize 
the interruption and prevent any further complications from arising. 

When you are confronted with an error message, stop what you are doing for a 
moment. Make note of what you are trying to accomplish and how far along you 
were when the problem came up. Then note the command that resulted in the 
error message (in most cases the command that you just typed in). This will 
come in handy if you have to ask your System Administrator^ or a more experi¬ 
enced user for help. This wiU also make it easier for you to pick up from where 
you left off should you need to play detective. 

The vast majority of error messages come as the result of mistyping a command 
or filename. So, check the command line for spelling errors and typos. 

Another common problem, even among experienced users, is being in the wrong 
directory when you type in a command. Check to see what directory you are in 
with pwd. 

If you have occasion to use another person’s accoimt, you may have forgotten 
which one you are currently using. When you are logged in as someone else, 
files that belong to your account may not be accessible. Check to see which 
accoimt you are using with whoami. 

If the steps so far haven’t revealed the source of the problem, then you are going 
to have to do some digging. So, along with your note about what you were doing 
when the problem occurred, copy down the error message exactly as it appears. 
This information will be important to you as you look for answers in this manual, 
and vital to anyone trying to help you. 

By following these steps, you wiU have gathered enough information to answer 
the important questions of: 

What? What, exactly, was the error message? 

When? At which stage in your work did the problem arise, and with which 

command? 


Where? What directory were you in? 

Who? Whose account were you using? 

This makes the questions of "Why did the problem arise?", and "How can I 
correct it?" much simpler to track down, especiaUy when you need to get expert 
help. 


^ If your WorkstaticMi is equipped with its own disk drive, then you may be able to perform tasks that we 
indicate should be referred to the System Administrator. These tasks are described in System and Network 
Administration. 
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Chapter 1 — Introduction 5 


1.2. Worst Cases 


Deleted Data or Files 


It is a good idea to check with your 
System Administrator about the 
backup scheduie for your system. 


We assume that you are using the 
C sheli. 


- \ 

Step 1: Stop. Make a note of what you are trying to accomplish and how far 

along you are. Make note of the specific command that resulted in 
the error message. 

Step 2: Check the command line for typing errors. 

Step 3: Check to see what directory you are in with pwd. 

Step 4: Check to see which account you are using with who ami. 

Step 5: Take down the error message exactly as it appears. Check this 

manual for answers, and if necessary, get help from your System 
Administrator or an experienced user. 


One problem that almost all beginners seem to face is anxiety about making a 
disastrous mistake. The fear that one may accidentally destroy valuable files or 
bring the system crashing down is as unnerving as it is exaggerated. (It takes 
more knowledge than most beginners have to do any serious harm). But, it’s 
only natural to be apprehensive when you aren’t sure of the risks involved. 

Perhaps the best way to overcome this anxiety is to learn what the realistic risks 
are, and what you can do to minimize them. 

It is possible to remove or erase the contents of a file unintentionally, but there 
are simple steps that you can take to help prevent this from happening. (It is also 
possible to make the system crash — say, by unplugging your keyboard and then 
plugging it back in — but it is normally quite easy to start it back up again.) 

Perhaps the worst problem that you wUl encounter as a beginner is the accidental 
deletion of a file or a portion of its contents. Once removed, a file is gone for 
good, and the same is trae for any contents that you erase. 

Your System Administrator should be making regular backup tapes of all files 
that change, and can usually recover a recent copy of the file containing all but 
the current day’s work. Still, losing a fuU day’s work on an important file can be 
a big disappointment. 

You can take the following steps to prevent your files from being accidentally 
deleted or overwritten. One thing you can do to help skirt the problem of lost or 
"trashed" files is to make a copy of the file from time to time — say, after every 
major change. This "shadow version" of your file will serve as a startup point if 
you should lose the original. 

If the following lines are not already contained in your . cshrc file, cd to your 
home directory and insert them:^ 


^ Refer to Setting Up Your SunOS Environment: Beginner’s Guide for more mformation about your 

. cshrc file. 
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6 Self-Help with Problems 



Figure 1-1 Safety Lines for Your . cshrc File 


c - 



A 

set noclobber 




alias cp 

'' cp 



alias rm 

' rm 

-i' 


alias mv 

''mv 

-i' 





J 


The set noclobber command prevents existing files from being overwritten 
when you use the > symbol to redirect output. The alias commands indicate 
that cp, rm and mv are to run with the -i option — to ask you for confirmation 
before removing or overwriting existing files. 

To make sure that these commands take effect immediately, type 

source .cshrc 

on your terminal, or in each cmdtool or shellt ool window currently run¬ 
ning. 


Be sure to open any shelltool 
or cmdtool windows that are 
iconic and run this command in 
them as well. 


Step 1: Insert the lines 


set noclobber 


alias cp 

' cp “i 

alias rm 

' rm -i 

alias mv 

''mv -i 

in your . cshrc file. 



Step 2: Run the command source .cshrc in every shelltool or 

cmdtool window, or on your terminal. 


System Shutdown If your System Administrator should need to take the system down while you are 

using it, you may see a broadcast message telling you that the system is about to 
shut down. Whenever the the system shuts down, it automatically saves files that 
you are editing with vi.^ Even so, it is a good idea to type I ESC I : wq as soon as 
you see the broadcast message. 

If you are miming other programs and want to make sure that the most recent 
data is saved, type in the sync command. 


^ also ex and ed. 
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Figure 1-2 Using sync 


r ." . ' 

... • '.;■ "■■■ . . .. '. 

..Venus % 

Broadcast Message 

from Venus !root. (console) af .12:44 

System Going Down 

sync 

venus% 

Immediately! 

V___^____ 

J 


To recover the file you were editing after the system has come back up, cd to the 
directory you were in at the time of the crash, and type in the command: 

vi -r filename 

Then, before you do anything else, type iii the command: 

: w 

This assures you that the recovered version is properly written out. 

- ^ 

System Shutting Down: 

Write and quit fi'om vi when you see the broadcast message, or use 
the sync command to force data to be saved. 

System Comes Back Up: 

Step 1: cd to each directory containing files you were editing 

and: 

Step 2: Usevi -r to recover preserved files. 

Step 3: vi displays the date the file was preserved on its mes¬ 

sage line, after checking this date, type in the command 
: w to assure that the preserved version is saved. 


System Crash If the system crashes, or shuts down unexpectedly, files that you are editing are 

preserved as indicated above. Should this happen while you are using the 
Workstation itself, the windows and mouse will cease to function and messages 
such as those shown below will appear at the lower left of the Workstation 
screen. If you are logged in on a tenninal, things will simply come to a halt. 

If you are logged in at a terminal Abort at 004832 

when the system crashes, contact 

your System Administrator for or 

assistance. 

panic: condition 

If the message says panic this doesn’t mean that thdXyou should. It means that 
the system’s internal software encountered some sort of rare and unusual error 
condition. The condition often clears up when you start the system back up. 
Even so, it is a good idea to take down the entire message for your System 
Administrator’s information before proceeding to restart the system. Even when 
the system comes back up successfully, it is best to report any panic messages 
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8 Self-Help with Problems 


to your System Administrator. 

The message is followed by a right angle-bracket (>). This is the monitor 
prompt. To restart (or reboot) the Workstation, type in the monitor command b 
when you see this prompt. 

Figure 1-3 Rebooting using b 





















































The system will display a series of messages and eventually ask you to log in.'^ 


- 

Step 1: If the word panic appears in the error message, take down what the 

message said. 

Step 2: When the monitor prompt appears, type in b to restart the system. 

Step 3: If the system hasn’t prompted for login in 15 minutes or so, contact 

your System Administrator for help. 

Step 4: Perform the steps in the previous section under System Comes Back 

Up 


Unresponsive Terminal When the temiinal (or cmdtool or shelltool window) gets confused or 

hung, there is often no error message. Instead, the terminal may not display 
things properly. It may display only its prompts and messages but not what you 
type, or it may display only what you type and nothing else. This sometimes 
happens when you interrupt an interactive game with I Ctrl-C I . 

To clear the terminal or window, use the reset command as follows: 


Figure 1-4 Using reset 

.;venus% 


( Lina Faed I 
reset 

I Line Feed ~1 


Even if the terminal doesn’t display anything, it often recognizes this command, 
and clears up. Use I Line Feed I rather than I Return I . because when it is confused, 
the terminal may not recognize (Return I properly. 

(It’s a good idea to be a bit patient with your machine, too. Many times a teimi- 
nal appears to be hung, when in fact it’s just slowed down due to heavy demands 
on it. This is especially likely if you are running several processes at once or if 
the network experiences particularly heavy usage.) 


■* Sometimes the system has to verify its data when it comes up again, and this can take up to 15 minutes. If 

you don’t get a login prompt by then, contact your System Administrator for assistance. 
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Chapter 1 — Introduction 9 


Error messages are often displayed when you type the first 1 Line Feed 1 . and the 
system finally looks at ever 5 dhing you have typed since the last successful com¬ 
mand. 

If this doesn’t clear things up and the problem is with a cmdtool or 
shelltool window, you may have to quit the window and open a new one. If 
the problem is with a terminal, you may have to get help fi’om your System 
Administrator. If you are logged in on a remote terminal over the phone lines, 
you may have to log out and dial in again. If you’re on a single-user Worksta¬ 
tion, reboot it. 
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2.1. Can’t Log In 


Account Not Set Up 


Can’t Remember Password 


Terminal Control Characters 
In Password 


Capitals in the Username 


Problems with Logging In, Logging Out 

and Passwords 

In order to log in to the system, you must have an account set up for you by your 
System Administrator. If this hasn’t been done yet, or if a mistake is made when 
setting up an account, you may not be able to log in. Problems with logging out 
can come up when you have stopped jobs, or when you attempt to log out from 
within a different shell (such as a shelltool window) than the one you logged 
in on. 

There is generally little that you can do about not being able to log in except to 
contact your System Administrator and wait for her or him to correct the prob¬ 
lem. 

If you have no account on a system, you carmot log in to it. If your system is 
connected to a network that uses the YeUow Pages network services, however, 
once your account is set up, it may be recognized by other machines on the net¬ 
work as well as your own. See Using the Network: Beginner’s Guide for more 
information, and check with your System Administrator to be sure. 

If you forget your password, you cannot log in. You must ask your System 
Administrator to change your password to something that is easy for you to 
remember. Once you can log in, you may want to change your password again 
so that it is known only to you. In general, long sequences of numbers, punctua¬ 
tion marks and other special characters are hard to remember, whereas words that 
evoke some meaning special ordy to you are easier to remember. 

Although you can use any character in your password, characters can be inter¬ 
preted as signals by the terminal such as I Ctrl-C 1 . 1 Ctrl-Z I . [ Ctrl-U I . 

I Ctrl-S 1 . 1 Esc 1 . [ Tab I . and in some cases CD and (@ I should be avoided. The 
terminal may interpret these as signals rather than text characters, and this would 
preclude you from typing in the password correctly. 

If you type your username in aU capitals when you log in, the system will behave 
as if the tenninal is "upper-case" only. All letters will be displayed in upper case. 
To avoid this, leave capital letters out of your username when you log in. 
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Misspelled Username or 
Mistyped Password 


No Home Directory 


No Shell 


Error Messages at Login 


2.2. Can’t Log Out 


Not Login Shell 


Stopped Jobs 


If you see the message 
Login incorrect 

tiy again. You may have miskeyed something. If, on the third try you stiU aren’t 
logged in, see your System Administrator. 

If you see the message 

No Directory! Logging in with home=/ 

This means that there is no directory set up for your use on the system. If this 
happens when you log in to another machine on the network, it may not matter. 
But if this happens when you log in to your own system, then you need to contact 
your System Administrator to have him or her set up a home directory for you. 

If you see the message 
No shell 

then an error was made when you account was set up. Consult your System 
Administrator. 

If you see an error message whenever you log in, there is probably an error in 
your .login file. If you see an error message whenever you start a new 
shellt o6l or cmdtool window, then there is probably an error in your 
. cshrc file. Since these files contain commands like those that you can type in, 
they are not too difficult to correct Refer to Setting Up Your SunOS Environ¬ 
ment: Beginner’s Guide for more information about these files, and to Doing 
More with SunOS: Beginner’s Guide for more information about commands that 
they contain. 

When you use the window system on your Workstation, you are logged in as 
long as SunView is running — even if you quit from every window in the 
display. To log out, you must exit SunView first.^ 

If the message 
Not login shell 

appears when you attempt to log out, you can use the exit command to kill the 
current shell, shelltool, or cmdtool. 

If the system responds with the message 
There are stopped jobs. 

then use the jobs command to see which commands are waiting. If you don’t 
care about any of them, a second command to log out wiU have the desired 
effect, and wiU terminate the stopped jobs as weU. Refer to Doing More with 

^ Logging out is one way to secure your WorkstaticHi against unauthorized use. Another is to use the ‘Lock 
Screen’ item in the SunView menu. 
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SunOS: Beginner’s Guide for more information about jobs, stopped jobs, and job 
control in the C shell. 

2.3. Can’t Change When you use pas swd to change your password, you must enter the old pass- 

Password word correctly, or it wiU reply with 

Sorry. 

and your password wiU remain the same. 

If you use the su command to assume another user’s identity,^ you cannot 
change that user’s password. Nor can another user change your password after 
gaining access with su. 

Network Access: Your YP The Yellow Pages network services maintains a separate list of user accounts and 

Password passwords for everyone with access to the network. When you log in to another 

machine and are prompted for a password, it is asking you for your YP password 
(which may be different than that on your current machine). 

To change your YP password, use the command yppasswd. This command 
works just like pas swd. As you are prompted to do so, type in your old YP 
password, your new YP password, and then confirm the new YP password. If 
you don’t know your YP password, the System Administrator for your network 
can issue you a new one. 


® See Doing More with SunOS: Beginner's Guide for more information. 
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Problems Running Commands 


Because there are error messages specific to every command, attempting to 
describe each and every one would only obscure those that are more general in 
scope. In this chapter we describe error messages that may come up when using 
just about any command. The next chapter describes those issued by selected 
commands that are used most often. Appendix A lists error messages that can 
arise when using the network to gain access to other machines. 


3.1. Problems with 

Command Line Syntax 




A 

,. 

. arg count 




j 


You specified either too many, or too few, arguments for the command. An 
argument follows a command and modifies it; it can be an option to that 
command, like Is -F, or a file that the command works on, like cat 
namelist, or so on. Many commands which require arguments will 
display the proper command syntax when just the command (no arguments) 
is typed in. See also Too few arguments and Too many argu¬ 
ments. 


- --- 

A 

Arg list too long 


V 

. ^ 


Your command substitution^ (or filename wildcard) expanded to form a 
command line of more than 10240 characters. This can happen when you 
use the cat command within backquote marks (') or when you use * in a 
directory containing an extraordinary number of files. 


r 

A 

Broken pipe 


. 

y 


The command that was receiving data from a pipe terminated before the 
command sending data finished. This usually means that the second or sub¬ 
sequent command encountered an error and died. For example, this can 


^ See Doing More with SunOS: Beginner's Guide for more information. 
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happen when piping output through more, if you quit more before the other 
command is done. You may have to look up commands in the pipeline in 
the SunOS Reference Manual to figure out what went wrong. 


r 

A 

exec failed: wrong binary format 


_ 



You’re attempting to ran software which will not run on the machine you’re 
using. This is likely to occur when you have copied a program from another 
user running a different kind of machine, or if you ran software which is 
specific to a particular release of SunOS. Often you can replace the program 
with a copy meant for your machine. 

If you have the source code for the program giving you this message, you 
may be able to recompile it on your own machine to make it work. 


r 

A 

File exists 


V 

> 


The command attempted to overwrite an existing file. Move the existing file 
to a new name with mv, or remove it with rm, and run the command again. 


- \ 

File name too long 

^; 


Your filename expansion string somehow expanded to a pathname with a 
component (directory-name or filename portion) exceeding 255 characters, 
or to a pathname exceeded 1023 characters. Try specifying the pathname 
explicitly. 


File not found 

_ J 


The file you attempted to look up or get access to is not in the directory. 
Refer to the discussion of find in Doing More with SunOS: Beginner’s 
Guide for information on how to look up a file when you don’t know the 
directory it is in. 


f 

A 

File too large 


V . 

. J 


9 

The size of a file exceeded the maximum (about 10 bytes). If you see this 
message, consult your System Administrator immediately. 
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-^ 

Is a directory 

V_____/ 


You attempted to read or write on a directory as if it were a regular file. 
(Can happen to anyone). 


-\ 

... No match 

\_/ 


The filename substitution pattern you gave did not match any files. 


No such file or directory 


This error occurs when a named file does not exist, or when one of the 
directory-names in a pathname does not exist. 


Not a directory 

_ / 


You supplied the name of a file to a command that expects a directory, such 
as cd. 


Not owner 


You tried to access or change permissions of a file that you don’t own, you 
attempted to kill a process that you don’t own, or, you attempted to run a 
command that can only be run by the superuser (root). Refer to "Processes 
and Other User’s" in Doing More with SunOS: Beginner’s Guide for more 
information. 


r 


Out of memory 


V . . . 



There are too many processes taking up memory on your Workstation. If the 
system’s performance is still good, then a good many processes may be idle 
and urmecessary. Use ps and kill to terminate idle processes that you 
own. Refer to Doing More with SunOS: Beginner’s Guide for more infor¬ 
mation about processes. 


f 

A 

Permission denied 


V 

J 


You attempted to either read, write, or execute a file for which you lack the 
proper permission. Refer to "Files" in Doing More with SunOS: Beginner’s 
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Guide for more information about files and permissions. 


- \ 

... stale NFS file handle 

_ / 


The rug got pulled out from under the file you were using. The file is in a 
remote-mounted file system that got unmounted by its host system (perhaps 
by a crash of that host), or someone on another machine removed it, or 
moved a new version into it while your command was stdl running. Do an 
Is on the directory to see if the file is still there. If the file is there, and its 
contents are what you expect, then rerun the command. 

If the file is missing, or its contents are unfamiliar, then you may need to get 
the version you need restored from backup. Files that are accessible from 
more than one machine may need to be protected using sees to prevent col¬ 
lisions like this. Refer to Doing More with SunOS: Beginner’s Guide for 
more information about sees. 

If no files are listed, have the System Administrator remount the filesystem 
on the remote host, and run the command again. 



A 

Too many arguments 


V_ 



The command you used expected fewer arguments. For instance, you can 
cd to only one directory. 


Too few arguments 


The command you used expected more arguments. For instance, mv 
requires a minimum of two arguments: a filename and its new name. 


r 

. \ 

Too many levels of symbolic links. 

j 


A pathname lookup involved more than 8 symbolic links. To reduce the 
nxunber of symbolic links needed to resolve the pathname, use Is -1 to 
look up the filename pointed to by the symbolic link. Then supply that 
name to Is -1, and so on imtil you reach the file or directory. 


r 

A 

Too many links 



-J 


You can have only 32767 hard links to the same file. Actually, if you see 
this message it could indicate that someone mistakenly made all those links. 
It is a good idea to report this to your System Administrator so that the prob¬ 
lem can be corrected. 
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r 


Usage: ... 





You typed in the command incorrectly, and it responded with a syntax 
diagram as a brief reminder. If the syntax summary is not clear to you, or if 
you need to know the full range of options open to you, check the SunOS 
Reference Manual. 


r 

A 

... Unknown option 



J 


The option you specified is not valid for the command you typed. See Too 
many arguments above. 


- ^ 

Unknown error 

V_/ 


The system encountered something very strange. Contact your System 
Administrator immediately. Do not attempt to correct this yourself. Your 
System Administrator needs to see the exact sequence of events leading up 
to this error message. 


3.2. Unforeseen Conditions 


r 

Disc quota exceeded. 

'N 

V 



You attempted to write on a file, create a new file, or create a new directory 
that would exceed your disc quota. 


f - 


Read-only file system 


V_ 



You attempted to write on a file or in a directory within a filesystem that is 
mounted read-only. 


... write failed, file system is full 


r 


File system full 


^. 

J 


There is no more room in the named filesystem. This message can come up 
when there are extremely large print jobs in the printer queue and you are 
running programs that use temporary files (such as vi) on a diskless Works¬ 
tation. Both the printer queue and the /tmp directory may be in the same 
filesystem, which gets filled up with data for the printer. The solution is 
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either to remove one or more print jobs or wait until those print jobs finish. 

If the printer queue is not the problem, the df and du commands can be 
used to look at a system’s file space. 


/- 


segmentation fault 


core dumped 


\_ 

J 


r 


Bus error 


core dumped 


V_ 

J 


The program failed to protect itself against an unexpected occurrence or 
internal error. The message core dumped means that the system has 
copied an image of the process into a file called core, in the current direc¬ 
tory, for use in debugging. If you don’t plan to attempt debugging, you 
should remove core, as it is often a large file. 

If the program can’t be debugged, the only recourse is to try rectifying the 
input, option, or condition that caused the problem — if such can be deter¬ 
mined. 

Sometimes segmentation faults are the result of poor memory management 
by programs. 
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Problems with Selected Commands 


To interpret an error message produced by a specific command not contained in 
this list, refer to that command in the SunOS Reference Manual 


cat 


cd 


f 

A 

cat: No such file or directory 

J 


Either you are in the wrong directory, the file does not exist, or you do not 
have permission to read it. 

cat: input filename is output 

V_/ 


You cannot cat the contents of filename to itself. Unfortunately, by the time 
you see this error message, the shell wiU have emptied out the file in 
preparation for writing to it. You can prevent this by having noclobber 
set, which prevents files from being written over, noclobber will give 
you the error message File exists. For more on noclobber, see 
Chapter 1. 


----- 

pathname: bad directory 

V___ 


You do not have permission to change to pathname. 


chmod 


----- 

chmod: can^t access filename 

V_ 


You attempted to change permissions of a file or directory that does not 
exist. You may be in the wrong directory. 
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You attempted to change permissions on a file you don’t own. 
chmod: invalid mode 


You specified the new permissions incorrectly. Perhaps you typed filename 
ahead of the permissions argument. 



The file specified by filename either doesn’t exist, or it does not have read 
permission. 



This usually indicates that you are in a directory which you don’t own, or 
you are trying to create a file in a directory for which you don’t have write 
permission. 



The filesystem or device you specified is not accessible. 
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Something is wrong in the file system. Notify your System Administrator 
and do not try to fix this yourself. 



Use the -h option when running dif f on huge files. 


grep 


You supplied an option that grep does not recognize. Refer to grep in the 
SunOS Reference Manual for a list of valid options. 



The search pattern, or (regular expression) on the command line is too long 
for grep to handle. You must shorten the expression, perhaps by perforaaing 
the search in stages using several grep commands within a pipeline. 



Either filename does not exist, or you do not have read permission for it. 

kill 


Either the process does not exist or has terminated. 
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f 



pid: 

not owner 




J 


You are attempting to kill a process which someone else started. Many 
automatic processes are actually owned by daemons. Often you can rlogin 
in as root and kill processes you don’t own. 


r 

r A 

Cross-device link 



J 


Is 


You attempted to create a hard link to a file in another filesystem. You may 
create a symbolic link instead. 

-\ 

filename does not exist 

_ ) 


The file named by the first argument does not exist. 


r 

A 

File exists 


V 

J 


A file by the name contained in the second argument already exists. 


f - 

-N 

In: name is a directory 


^ . 

J 


Use the -s option to make a symbolic link to a directory. 


/ N 

directory unreadable 

\_/ 


You do not have read permission for directory. 



Some options of the Is command sort the filenames before displaying them. 
This message occurs when there is not enough memory available to perform 
the sort. Use ps and kill to eliminate extraneous (idle) processes. See 
Doing More with SunOS: Beginner’s Guide for more information. 
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make 


mkdir 


man 


mount and 


-\ 

Don't know how to make target 

^ _> 


You asked make to process a target not contained in your makefile. 


r —^ 


mkdir: cannot access directory 

J 


directory does not exist or you don’t have read access to its parent. This 
may come up should you try to create a subdirectory before its parent direc¬ 
tory is created. This also appears when the parent directory does not have 
write access. 

mkdir:cannot make directory dir 
The directory specified by dir already exists. 


( -- 

" . ^ 

No entry for item... 


V 

J 


There is no entry for the item you asked for in the online Manual Pages, or 
in the section you specified. 


umount 


( - 

Block device required 

Y 

V 

You tried to mount something other than a filesystem. 


r 

Mount device busy 


V.._ . . .._ ____ 


You attempted to mount filesystem that is already mounted, or to dismount a 
device on which there is a file in use. 

r 

You must be root to use mount 





You must be logged in as root (the superuser) to use these commands.^ 

If you know the root password for your Workstation, use su -f to quickly 
"become root" and run the command. Commands in Section 8 of the SunOS 
Reference Manual are typically run by root. 


* mount with no arguments displays the filesystems you currently have mounted. You do not have to be 

root to use mount this way. 
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- \ 

Too many levels of remote in path. 

_ J 


You attempted to mount a remote filesystem within another remote-mounted 
filesystem. 


mv 


can't mv directories across file systems 


Use cp -r to copy the directory, its files, and any subdirectories (with their 
files) to the new location. Then use rm -r to remove directory and its files 
from the old location. 


r . 


mv: directory rename only 


\_ 

j 


This message appears if you type a command of the form: 
mv filename olddir newdir 


You can either move a list of filenames to a new directory, or move a single 
directory to a new name, but not both in the same command line. 




mv: cannot unlink filename 


V .. _ 



Usually arises because you are not the owner of the directory containing 
filename. 


mv: cannot move a directory into itself 

. _ > 


The source and destination directory names must be different. 


pwd c ^ 

pwd: cannot open .. 

\ _ / 


The parent directory has somehow become read protected, and the pwd 
command cannot read it to determine the pathname of the current directory. 
This can happen when you have more than one cmdtool or shelltool 
window open and, from within another window, you change the permissions 
of any directory in the pathname of the current directory. The C shell com¬ 
mand dirs may serve instead of pwd. 
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rm -r and rmdir 


Note: 


rm -r will silently remove a full directory just as long as 
o You own it; and 
□ noclobber is not set. 


r 

A 

Directory not empty. 



J 


There are still files in the directory. Use Is -a to see them all. 

-s 

filename not removed 

_ y 


Either you lack write permission for the directory that contains the file, or 
you did not answer with a y when asked for confirmation to remove the file. 


troff and nroff 


^Core limit reached. 

A 

_J 

Refer to Out of memory in Chapter 3. 



Segmentation fault. 


core dumped. 



J 


A closing macro was missing. Use checknr to obtain a list of possible for¬ 
matting errors. The message core dumped indicates that the system 
copied an image of the process where it left off for further diagnosis, if 
needed. 


Typesetter busy. 


Either troff was not properly installed on your system or network, your 
system uses a local version, or the phototypesetter is temporarily unavail¬ 
able. Consult your System Administrator to find out which is the case. 
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Problems Editing Text Files (with vi) 


As the standard SunOS text editor, vi is one of the first programs introduced to 
you in Getting Started with SunOS: Beginner’s Guide Few text editing programs 
can match it for power, or for a better "fit" within SunOS. It is, however, by no 
means the only text editor available. Along with several line editors such as ex 
and ed, the window-based editor textedit, offers some very attractive 
features.^ You cannot, however, use textedit on a terminal other than the 
Workstation, or when you rlogin to another machine to edit files that reside 
there. In these cases, you may need to use vi. 


Or, rather than using rlogin to get 
access to files on another system, 
you can su to become root on 
your system, then mount the direc¬ 
tory containing the files you want. 
Once mounted, you can use that 
directory just like any other directory 
on your system. Refer to mount in 
the SunOS Reference Manual for more 
information. 


So, even if you adopt another editor as your favorite, you may still have occasion 
to use vi. 

When you can solve the sorts of problems that may arise with vi, you will be 
better equipped to resolve problems with whatever editor you may use. 


5.1. Operating Problems The problems described in this section require you to perform specific tasks in 

order to avoid losing text or changes made since the file was last written. 

Deleted Wrong Text or Need When you have made several deletions, such as when you use dd successively to 

Previously Deleted Text delete lines, you may find that you want some of the deleted text back again. If 

you want the most recently removed line, you can use u (undo) to restore it. But 
suppose you want to undo the third-to-the-last deletion? 

When you delete text (of a line or more), vi saves that text in a buffer. There are 
nine numbered buffers that contain up to the 9’th most recent deletion. To 
recover the n’th most recent deletion, use the p command as follows: 

"np 

When you delete a word or portion of a line, this text is not saved in a buffer. If 
you want to recover it, say, after adding some more text (in which case u won’t 
work) use p (put). 


^ See SunView 1 Beginner*s Guide for more infomiation. 
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Nested Editing Sessions One common error in using vi is to run multiple copies of vi simultaneously on 

the same file. It’s very easy to lose a lot of editing work this way. 

You lose work because each time you run vi on a file, you edit a completely 
separate copy of the file. When you’re done editing, you make that copy’s 
changes pennanent by writing it out to a storage place called a hard disk. If you 
do simultaneous edits on the same file, then each time you end vi you’ll write 
over any changes you might have made in other copies. 

There are two common ways of accidentally miming vi more than once on the 
same file. One way is if you are editing a file and you use (Ctrl-Z I to temporarily 
stop vi and put it in the background, and then type vi to go back to editing the 
file. If you do escape vi with I Ctrl-Z I . do not go back into vi by typing vi; 
rather, use the % command, as explained in Doing More with SunOS: Beginner’s 
Guide. This puts you back into your original editing session. 

The other way is use the : ! shell escape, which allows you to mn SunOS com¬ 
mands from within vi. One such command that you can run is, oddly enough, 
vi. It’s okay to use : ! vi filename only if you edit a dijferent file. Do not 
attempt to use this sheU escape to edit the file you’re already editing. 

Try this on a test file to see how it can happen; 

CAUTION Do not run this test on a file containing information of any value. 


Make a copy of a file and caU it test. Run vi on the file. 


r 


venus% cp memo 1:est 


venus% vi test 


(vi screen comes up) 


V 

• J 


Now, use : ! to mn vi again. When the new vi screen comes up, delete its con¬ 
tents with dG, then go to the first vi session with : wq. 


:! vi test 


] 

\ vx ccfit Lur 

d(5 

citextisdekted 

fr 





; :wq 

(.previous text cotr 

tes up) 


At this point you can check to see that the written-out version of the file has less 
text by miming the command : ! more test 


f ----- 

: f more test 



{Hit 1 Return \ to continue) 

N___ 

■ 


After typing I Return I . write and quit, then mn more test from the C shell. Lo 
and behold, the contents are back! But what would have happened if you had 
added text rather than deleting it in the "inner" vi session? 


If you accidently do find yourself doing multiple edits of a single file, exit from 
that session with : q!. 
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Recovered Wrong Version If you type in the -r option, and the file you are editing was once preserved dur¬ 

ing a crash (but not yet recovered), vi wiU recover this older, and probably out¬ 
dated version. If the date displayed for the file does not correspond to the most 
recent crash, do not write the file and do not edit it. Rather, check the file very 
carefully to see if it is up to date. If it is not, then use : q! to exit immediately 
from vi. Or, if in doubt, use 

:w filename ."BSC 

to save the recovered version. You can then exit vi and run dif f to compare 
the two versions of the file. 

If you have already typed : w, you may have to have the System Administrator 
recover the more recent version from backup tape. 

When you edit a file for which you don’t have write permission, you can still 
make changes to the temporary copy vi uses. If you don’t own the file, you can 
write out a modified copy by supplying a filename to the : w! command: 

: w! newfile 

If you have write permission on the directory, you can exit vi and use mv to 
replace the existing version of the file with your modified version. 

If you own the file, you can force the changes to be written out, even though vi 
complains. To force the changes to be written, use the command 

:! chmod +w % 

to give yourself write permission on the file. The percent sign is a symbol that 
stands for the name of the file currently being edited. Then use 

: w! 

to force the changes to be written. Of course, if you don’t own the file, this won’t 
work. 

Ran Out of Disk Space If, when you attempt to write a file, you get a message that the file system is full, 

then you will need to find another filesystem with more space. Use the command 

: !df 

to see which filesystems have space available and pick a directory in one of them. 
To write the contents onto a new file in this other directory, use the command 

: w! pathname 

Next, notify your System Administrator about the fuU disk, so that she or he can 
move some of the files to another disk or remove them to tape. 

If you get a message indicating that your disk quota has been reached, you may 
either have to forego writing your changes, or go searching for files to remove 
instead. (You can use I Ctrl-Z I to suspend vi while you hunt for files to remove. 
Use % to resume vi where you left off.) 

If the system drops from vi into open mode and indicates a file system is full, 
this means that the disk containing vi’s temporary files fiUed up. Use the 


Can’t Write Changes 
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Truncated or “Skipped” 
Lines, or Cursor Tracking 
Errors 


vi Comes Up as ex 


Bug: Repeating an Insertion 
with an Embedded Word 
Wrap 


5.2. vi Error Messages 


command 
! Is /tmp 

to see if there are files that you can remove. If you have queued up large print 
jobs, you may have to remove some of them, or wait imtil they’ve printed, to 
regain disk space for vi. 

Another directory to look in is /usr/var/adm. It contains a number of files 
which contains records of your activities on the machine, such as the file mes¬ 
sages, which keeps aU the messages your system sends you. These files should 
be cleared out from time to time. (You must be the supemser, root, to do this; 
see Doing More with SunOS: Beginner’s Guide for information on becoming 
supemser.) If you are sure that you don’t need the file, use vi to remove its con¬ 
tents. 

When you r login to another machine, use a standard-sized shelltool win¬ 
dow. Using a window that is smaller can cause vi to skip the top few lines. If 
you then write out the file, the skipped lines will be deleted. 

If the window is larger than standard, the cursor may not accurately track your 
location within the file, and you won’t be sure of what changes you may be mak¬ 
ing. 

If either of these should happen to you, use 
:q! 

to exit vi, and then open a new shelltool window from which to mn rlo- 
gin. 

You typed an interrupt signal before vi could draw the screen. Use the com¬ 
mand vi to begin (or resume) full-screen editing. 

If you insert a long string of text, and then use the dot (.) command to repeat the 
insertion, if that repeated insertion extends beyond the end of the line to cause a 
word wrap, vi garbles the text to be inserted. To avoid this problem, use y 
(yank) and p (put) to replicate the inserted text. 

Should a problem arise during an editing session, vi may display one of the 
messages listed below. 
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Problems Starting Up 


... 


Bad termcap entry 


Termcap entry too long 


terminal : Unknown terminal type 


Block device required 


V 

J 


r 


Not a typewriter 


V_ 



vi could not figure out how to work with the terminal you are using. See 
you System Administrator to correct this problem. 


r 

A 

Block special file 


Character special file 


Directory 


Executable 


Non-ascii file 


file non-ASCII 


V_ 

. J 


Bad file number 

_ / 


The file you attempted to edit was not a regular text file. 


Problems with File Recovery 


Can't fork to execute recovery 
Can't make pipe for recovery 


- 

[Warning - file is incomplete] 

V_> 


vi was unable to recover aU or part of a file preserved after a crash. See 
your System Administrator. You may have to recover an earlier version of 
the file from backup tapes. 
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Problems Writing a File 


f 


File exists 


File exists - use w! file to overwrite 


V_ 

J 


r 

[Existing file] 


c . 

J 


When you specify a file to write with : vi filename, vi checks to see if a file 
by that name already exists. If so, you see one of these messages. Use : w! 
filename to overwrite the file. 


[Read only] 

File is read only 

V_ J 


--- 

Permission denied 

V___ ) 


Either you are running view, or you lack write i^rmission for the file. In 
either case, see under Can’t Write Changes, above. 
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Problems with Network Access 


The following messages indicate a problem accessing a remote system over the 
network. 


\ 

NFS server name not responding still trying 
NFS server name okay 

_ 


The network equivalent of “Don’t touch that dial; we are experiencing 
technical difficulties.” Your server is having trouble connecting with the 
server name, this message often shows up when the remote server is very 
busy and your machine has to wait for service. Wait a bit to see if the con¬ 
nection is eventually made or regained. If the message continues, the remote 
machine may have “died.” 


/- 


Connection refused. 


V 

J 


The remote machine is unavailable at present. 


f 

Connection timed out. 


^ . 

. y 


The remote machine failed to respond within the required time limit. Either 
it is too busy to accept new connections, or it is restarting (rebooting) after a 
crash. 


/-— 

Network dropped connection on reset. 



J 


The host you were connected to crashed and rebooted, dropping the network 
connection to your system. 
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G 
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H 
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I 
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J 
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K 
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Network dropped connection on reset., 45 
network password, 15 
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NFS servername not responding still trying,45 
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No match, 21 

No such file or directory, 21 
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noclobber command, 27 

Non-ascii file, 41 

Not a directory, 21 
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Not owner, 21 

nrof f program, 33 

o 
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pathname', bad directory^ 27 

Permission denied, 3, 21, 42 
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pid: not owner, 30 

preventing accidental deletion of files, 5 
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restarting system after a crash, 8 
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rlogin command, 37 

rm command, 33 

rmdir command, 33 

s 

segmentation fault, 24 
Segmentation fault., 33 
Stale NFS file handle, 22 
system crash, 7 
system shutdown, 6 

T 
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terminal : Unknown terminal type, 41 
terminal, unresponsive, 8 
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too many files, 30 

Too many levels of remote in path., 32 

Too many levels of symbolic links., 22 

Too many links, 22 
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truncated lines in vi, 40 
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Unknown error, 23 
unknown flag, 29 
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... unreadable, 30 
unresponsive terminal, 8 
unresponsive window, 8 
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and a full disk, 39 
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and deleted text, 37 
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can’t write out changes, 39 
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cursor tracking problems, 40 
nested sessions, 38 
problems starting up, 41 
problems with file recovery, 41 
problems with writing a file, 42 
recovered wrong version of file with -r, 39 
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